home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 003 / dmenu.arc / DMENU.DOC next >
Encoding:
Text File  |  1986-01-17  |  5.0 KB  |  109 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                                                      
  18.  
  19.  
  20.                                 Documentation
  21.  
  22.  
  23.                          ::::::::::::::::::::::::::::
  24.                          :::                      :::
  25.                          :::       dMENU          :::
  26.                          :::       v1.00          :::
  27.                          :::                      :::
  28.                          :::    Dec. 17, 1984     :::
  29.                          :::                      :::
  30.                          ::::::::::::::::::::::::::::
  31.  
  32.                               By - Danny Burkes
  33.                                    1080 Barber Creek Lane
  34.                                    Watkinsville, Ga 30677
  35.  
  36.  
  37.  
  38.                                   DISCLAIMER
  39.           
  40.     This program has been provided free of charge to you, the end user.  
  41. Therefor there is NO warranty, either expressed or implied, as to the 
  42. performance (or non-performance) of this product, it's fitness for a specific 
  43. purpose, or anything else you can think of.  By using this program, you assume 
  44. all responsibility for anything that happens.  In others words, if it blows up 
  45. your machine, it ain't my fault.
  46.                                               
  47.  
  48.  
  49.                            PROGRAM CONCEPT AND USAGE
  50.        
  51.     Now that we are through all the trivial pursuits, we can get to the good 
  52. stuff, like what this program does.  This program helps out the dBASE 
  53. programmer by simplifying the process off creating a menu screen and the error 
  54. checking that goes along with that menu screen.  As a dBASE programmer,  I 
  55. found that the most tedious part of designing a menu-driven system 
  56. (i.e.-accounting, mailing list, etc) was coding in the menu screens themself.  
  57. I'm not saying that they were the hardest, to the contrary, they were the 
  58. easiest.  Every one was practically identical except for the text on the 
  59. screen and the various command files executed following a menu choice.  Well 
  60. that gave me an idea (wham-boom-lights flashing,etc...) to write a program to 
  61. automate this process of typing the same thing over and over.  After all, 
  62. that's what computers do best anyway (repetitive tasks).  So I sat down and 
  63. wrote this BASIC program to do just that.  Well, after using it for a while, 
  64. Ashton-Tate pulls one and comes out with dBASE III.  After examining III, I 
  65. found that the commands were essentially the same, so I re-wrote the program to 
  66. accommodate either program.  Then I thought that maybe some of the other users 
  67. out there in BBS land might want to use the program too, so I decided to 
  68. distribute it.  Okay - Now on to using the program.  dMENU is VERY easy to 
  69. use, in fact I know ANY dBASE programmer could use it without reading this 
  70. documentation.  After typing 'dMENU' at the system prompt, you will see the 
  71. fancy-pants opening display, and then the actual program screen will come up.  
  72. First you tell dMENU the filename you want the command file to have.  You 
  73. don't have to put a ".PRG" here, if you omit an extension, dMENU will assume a 
  74. ".PRG".  You may also leave this blank and just press <ENTER> here to leave 
  75. the program. You then tell it how many choices to put on the menu.  Note that 
  76. the maximum is 9.  Future versions of the program may include the ability for 
  77. more choices, but the screen gets pretty crowded (and confusing to the user) 
  78. if you put 16 menu choices.  Whether or not there ARE future versions will 
  79. depend on the interest shown in this program.  Even if you don't send money, 
  80. drop me a letter with your evaluation of the program (likes, dislikes, bugs, 
  81. etc) so that I can asses the response to the program.  Okay, next dMENU will 
  82. ask you if this command file is for dBASE II or III.  This determines the 
  83. commands that dMENU uses to tell dBASE to clear the screen ("erase" or 
  84. "clear"), and the uppercase conversion sign ("!(var)" or "upper(var)").  Next, 
  85. you enter the text to appear by the various choices, and the name of the 
  86. command file to be executed if this option is chosen.  After you finish this, 
  87. the rest is automatic.  dMENU generates the command file, and then asks you if 
  88. you would like to go again. 
  89.  
  90.  
  91.  
  92.                           DONATIONS AND PARTICIPATION
  93.  
  94. This program is in the public domain and may be freely copied and given away, 
  95. as long as no price is charged for the program itself.  If you use this program 
  96. and find that you like it, you may send an unsolicited donation 
  97. ($10 suggested) to the address listed at the beginning of this documentation.  
  98. Please don't feel that you have to send money to write me about the program.  
  99. As I said earlier, even if you don't send money, drop me a line so that I can
  100. asses the interest in this program.  This program is just the tip of the 
  101. iceberg as to what can be done to simplify dBASE programming (Fox & Geller 
  102. have proven that).  I encourage people to write programs like this and 
  103. distribute them.  Together, we can take the hassle out of dBASE programming. 
  104.  
  105.  
  106.  
  107.  
  108. 
  109.